ソフトバンクまとめて支払い

ソフトバンクまとめて支払い(継続課金) ファイル送信仕様

ソフトバンクまとめて支払い継続課金では、当サービスから加盟店様へ課金ファイルを送信します。月初（課金要求）、また課金日当日（課金確定）にソフトバンクセンターで処理された結果をショップID単位に作成します。
送信先は当サービスショップ管理画面の、メニュー「継続決済」＞「ソフトバンク継続課金」＞「設定」にて設定します。
それぞれのファイルは処理当日内に加盟店様へ送信します。ただしメンテナンスや障害発生時には遅延する可能性があります。
加盟店様側からの正常応答が確認できなかった場合は60分おきに5回再送します。

注意

結果通知プログラムにおいて、決済結果をhttps通信にて受け取る場合は、第三者が発行したSSLサーバ証明書が必要になります。
尚、弊社で動作保証をしている電子証明書は下記になります。
　・ベリサイン
　・GlobalSign
　・日本ジオトラスト
※上記以外の電子証明書を使用する場合は、必ずテスト環境で疎通確認してください。

課金要求結果ファイル/課金確定結果ファイル

ファイル出力対象

課金要求結果ファイルに出力される情報は以下の通りです。

・月初に、当月の課金対象に対し課金要求を行った結果データ
・課金要求が成功または失敗の課金データ

課金確定結果ファイルに出力される情報は以下の通りです。

・課金日当日に、当月の課金要求が成功したデータに対し課金確定を行った結果データ
・課金確定が成功または失敗の課金データ

ファイル情報

課金結果ファイルは、ヘッダ、データ（課金データ件数分）、フッタの３種類のレコード構成となります。

出力パラメータ（当サービス⇒加盟店様）
fileContents 必須 ファイル
ファイル
課金要求結果ファイル、または課金確定結果ファイルを返却します。
■ファイル情報
ファイル名
【課金要求結果ファイル】
SB_A_ショップID_課金要求日_[0-9].csv
(例)SB_A_tshop99999999_20151001_5957685870812785188.csv
【課金確定結果ファイル】
SB_S_ショップID_課金確定日_[0-9].csv
(例)SB_S_tshop99999999_20151031_150863765215807927.csv
区切り文字
半角コンマ
改行コード
CRLF
ソート順
オーダID 昇順
囲み文字
ダブルクォート


■ヘッダレコード
レコード区分 必須 半角英字2桁
"HD"固定となります。
ショップID 必須 半角英数13桁
ショップIDを設定します。
データレコード件数 必須 半角数字8桁
データレコードの件数を設定します。


■データレコード
ショップID 必須 半角英数13桁
オーダーID 必須 半角英数記号27桁
課金日 必須 半角数字6桁
課金日をyyyyMMdd書式で返却します。
取引状態 必須 半角英字15桁
取引状態を返却します。
【AUTH：課金要求済み】
【AUTHFAIL：課金要求失敗】
【SALES：課金済み】
【FAILED：課金失敗】
利用金額 必須 半角数字6桁
税送料 必須 半角数字6桁
ソフトバンク処理トラッキングID 半角数字14桁
エラーコード 半角英数3桁
エラー詳細コード 半角英数9桁
処理日時 必須 半角数字14桁
処理日時をyyyyMMddHHmmss


■フッタレコード
レコード区分 必須 半角英字2桁
"FT"固定となります。


入力パラメータ（加盟店様⇒当サービス）
RecvRes 必須 半角数字1桁
受信結果
以下のいずれか
0：受信OK
1：受信失敗